home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-20 / tcm.zip / TCM.DOC < prev    next >
Text File  |  1991-11-10  |  21KB  |  619 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                THE CODE MACHINE
  10.  
  11.                                  Version 3.0
  12.  
  13.  
  14.                          * Lloyd J. Wilson, N6IKH
  15.                            1530 W. Ranch Rd
  16.                            San Bernardino, CA  92407
  17.  
  18.  
  19.  
  20.  
  21.                               TABLE OF CONTENTS
  22.  
  23.  
  24.         I.  Introduction .......................................  2
  25.        II.  Getting Started ....................................  2
  26.       III.  Menus ..............................................  3
  27.        IV.  Transmit ...........................................  3
  28.         V.  Words Per Minute (WPM) .............................  4
  29.        VI.  Call Sign ..........................................  6
  30.       VII.  Messages ...........................................  6
  31.      VIII.  Practice ...........................................  7
  32.        IX.  Help ...............................................  8
  33.         X.  Quit ...............................................  8
  34.        XI.  Special Characters .................................  8
  35.       XII.  Connection to Your Transmitter .....................  9
  36.      XIII.  Date and Time ......................................  9
  37.       XIV.  System Speed .......................................  9
  38.        XV.  Disk Files ......................................... 10
  39.  
  40.  
  41.  
  42.  
  43.  
  44.            * Note: At some time in the future this address
  45.                    may become obsolete.  If you need to
  46.                    contact me and can't reach me at this
  47.                    address, you might find my address
  48.                    in a current Call Book.
  49.  
  50.      
  51.  
  52.  
  53.  
  54.      ╔══════════════════════════╗
  55.      ║ SECTION I - INTRODUCTION ║
  56.      ╚══════════════════════════╝
  57.  
  58.      This program is distributed as Public Domain Software.  The
  59.      Copyright is retained by the author.  The program may be freely
  60.      copied, placed on any bulletin board system, or otherwise
  61.      freely distributed.  Shareware distributors and bulletion board
  62.      services may charge their standard rates.
  63.  
  64.      No fees are solicited for use of this program, and none will be
  65.      accepted.
  66.  
  67.  
  68.      ╔══════════════════════════════╗
  69.      ║ SECTION II - GETTING STARTED ║
  70.      ╚══════════════════════════════╝
  71.  
  72.      The Code Machine requires and IBM PC, XT, AT, or compatible, at
  73.      least 256K of RAM, and PC-DOS or MS-DOS 2.0 or higher.
  74.  
  75.  
  76.  
  77.      Floppy Disk Systems
  78.  
  79.      To run The Code Machine on a floppy-based system, copy all
  80.      files on The Code Machine distribution disk to a boot disk (a
  81.      disk formatted with the /s option).  After booting up with this
  82.      disk, enter `TCM` (for The Code Machine) to start the program.
  83.  
  84.  
  85.  
  86.      Hard Disk Systems
  87.  
  88.      Create a new directory called "CODE". Copy all files on the
  89.      distribution disk into \CODE.  Log into this directory and
  90.      enter `TCM` to start the program.  This sequence would be as
  91.      follows:
  92.  
  93.                C>MD \CODE
  94.                C>COPY A:*.* \CODE
  95.                C>CD \CODE
  96.                C\CODE>TCM
  97.  
  98.  
  99.  
  100.      Batch Files
  101.  
  102.      A batch file will allow you to enter the program without
  103.      changing directories.  The following example of a batch file
  104.      named TCM.BAT (located in the root directory or a directory for
  105.      which a path has been established) will let you start The Code
  106.      Machine by entering `TCM`:
  107.  
  108.  
  109.               CD\CODE
  110.               TCM
  111.               \CD
  112.                                      -2-
  113.      
  114.  
  115.  
  116.  
  117.      Manual
  118.  
  119.      To print this manual, align your paper to the top of a page, then
  120.      at the DOS prompt type in the following command:
  121.  
  122.                                 PRINT TCM.DOC
  123.  
  124.  
  125.  
  126.      ╔═════════════════════╗
  127.      ║ SECTION III - MENUS ║
  128.      ╚═════════════════════╝
  129.  
  130.      The Code Machine's menus work like most standard program menus 
  131.      today.  You may either use the arrow keys to identify the
  132.      selection you want and then press the [ENTER] key, or you may
  133.      simply press the first character of your selection.  The second
  134.      method is generally preferred as it requires only one keystroke
  135.      to obtain the desired menu selection.
  136.  
  137.  
  138.  
  139.  
  140.      ╔═══════════════════════╗
  141.      ║ SECTION IV - TRANSMIT ║
  142.      ╚═══════════════════════╝
  143.  
  144.      Once you enter the transmit mode, you will see the cursor
  145.      located at the beginning of the transmit buffer.  Code will be
  146.      transmitted as soon as you begin typing characters into the
  147.      buffer.  You will hear a series of clicks on your speaker as you
  148.      type in characters.  This is the sound of a D.C. signal being sent
  149.      to your speaker port, this is also the signal that will drive your
  150.      transmitter (see Section XII, "Connection to Your Transmitter").
  151.      If you want to hear an audible tone from your speaker, select
  152.      "Practice" then "Use Transmit Buffer" from the menu.
  153.  
  154.      The characters will be transmitted at the WPM previously selected
  155.      (see Section V, "Words Per Minute").  If you select a character for
  156.      which a message exists in your message library, that message will
  157.      be placed into the transmit buffer (see Section VII, "Messages").
  158.  
  159.      As the code is transmitted, the character that is currently being
  160.      sent will blink.  The transmit buffer is 13 lines long which allows
  161.      you to enter over 1000 characters (13 X 80 = 1040) ahead of what is
  162.      being transmitted.  If more space is needed, the buffer will scroll
  163.      to make room for the additional characters.  The buffer will not
  164.      scroll until all the characters in the top line have been
  165.      transmitted.  For messages, four lines must be available before a
  166.      scroll will occur.
  167.  
  168.      The [ESC] escape key will (1) suspend transmission, (2) clear the
  169.      transmit buffer, and (3) return control to the main menu.  It is
  170.      not necessary to leave the transmit buffer between copying and
  171.      sending sessions, as the program waits when it reaches the cursor.
  172.      Transmission will start again when additional characters are
  173.      entered.
  174.  
  175.                                      -3-
  176.      
  177.  
  178.  
  179.  
  180.      The [CTRL]-[S] keys pause transmission until another key is
  181.      touched.  If you select to pause the transmission in the middle of
  182.      a character, the program will resume transmission with the next
  183.      full character, thus preventing transmission of a partial
  184.      character.
  185.  
  186.  
  187.  
  188.      ╔════════════════════════════════════╗
  189.      ║ SECTION V - WORDS PER MINUTE (WPM) ║
  190.      ╚════════════════════════════════════╝
  191.  
  192.      The Code Machine offers an extremely versatile selection of code
  193.      speeds and modified code speeds.  The speeds and modifications
  194.      selected under menu choice WPM control both the code transmission
  195.      speed and the speed of the practice programs.  Selection of code
  196.      speeds falls into three categories: (1) true speeds, (2) modified
  197.      speeds, and (3) space-elongated speeds.
  198.  
  199.  
  200.      True Speeds
  201.  
  202.      True code speed is just what the name implies. True speed complies
  203.      strictly with the guidelines outlined in the ARRL Handbook: dit = 1
  204.      unit dah = 3 units space between character elements = 1 unit space
  205.                between characters = 3 units space between words = 7
  206.                units average units per word = 50 units
  207.  
  208.  
  209.      To enter the desired true code speed simply select the WPM option
  210.      off the Main Menu, enter any speed between 1 and 100, and press the
  211.      [ENTER] key.  The speed you selected will be displayed at the top
  212.      right-hand corner of your monitor, followed by a comma and "True".
  213.  
  214.      Modified Speeds
  215.  
  216.      Working at slower speeds can be somewhat distracting because the
  217.      lengths of the characters increase excessively.  For example, at 1
  218.      WPM the true length of a dah is 3.6 seconds.  Even at 5 WPM the dah
  219.      is almost 3/4 of a second long (.72 seconds).  With the modified
  220.      speed option, all characters are transmitted at 12 WPM, however,
  221.      the spaces between the characters and words are increased to obtain
  222.      the overall speed selected. To select the modified code, enter a
  223.      comma then a `M`  (for modified) following the overall speed you
  224.      select.  For example, if you want 8 WPM modified code you will
  225.      select WPM off the Main Menu and enter the following:
  226.  
  227.                        8,M   (then press the [ENTER] key)
  228.  
  229.      The speed you selected will be displayed at the top right-hand
  230.      corner of your monitor followed by a comma and "Mod".  Of course,
  231.      this option only works at speeds under 12 WPM.
  232.  
  233.  
  234.  
  235.  
  236.  
  237.                                      -4-
  238.  
  239.      
  240.  
  241.  
  242.  
  243.      Space-Elongated Speeds
  244.  
  245.      If you listen closely to a station working CW, you will notice that
  246.      amateurs often leave more space between characters than the three
  247.      units (dah length) of true code, especially when working at the
  248.      slower speeds.  The Code Machine will let you recreate this type of
  249.      code transmission by increasing the space between characters.  You
  250.      can increase the space from 1.1 to 9.9 times what the true length
  251.      would be.  The way to select this option is choose WPM from the
  252.      Main Menu, select your WPM then enter a comma followed by the
  253.      increase desired (elongation factor).  For example, if you want to
  254.      double the space between characters and send characters at a rate
  255.      of 10 WPM, enter the following at the WPM prompt: 10,2
  256.  
  257.      If you only wished to increase the length by 1 1/2 times (a 50%
  258.      increase) you would enter:
  259.  
  260.                  10,1.5
  261.  
  262.  
  263.      1 3/4 would be:
  264.  
  265.                  10,1.75
  266.  
  267.  
  268.      2 1/2 would be:
  269.  
  270.                  10,2.5
  271.  
  272.      and so on.
  273.  
  274.  
  275.      With the space-elongated selection, the characters will be sent at
  276.      the true rate, however, the increased length between characters
  277.      will decrease your overall transmission rate.  Your actual rate can
  278.      be calculated with the following formula:
  279.  
  280.                         WPM = WPM - ((WPM X .38)(X-1))
  281.  
  282.                           where X = elongated factor
  283.  
  284.      So, for example, if you selected 13 WPM and doubled your space
  285.      between characters (13,2) your actual code speed would be:
  286.  
  287.                           WPM = 13-((13 X .38)(2-1))
  288.                           WPM = 13-(4.94 X 1)
  289.                           WPM = 13-4.94
  290.                           WPM = 8.06
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.                                        -5-
  300.  
  301.  
  302.      
  303.  
  304.  
  305.  
  306.      ╔════════════════════════╗
  307.      ║ SECTION VI - CALL SIGN ║
  308.      ╚════════════════════════╝
  309.  
  310.      The call sign option is a very power and useful capability of The
  311.      Code Machine.  To use the option, simply select `Call Sign` from
  312.      the Main Menu and at the prompt enter the call sign of the station
  313.      you are working.  The call sign will be displayed in the upper left
  314.      corner of your monitor.  Once you have entered the call sign press
  315.      [ENTER] to return to the Main Menu.
  316.  
  317.      Now when you are entering data in the transmit buffer, you can
  318.      simply select the colon [:] key and the station's call sign will be 
  319.      entered into the transmit buffer.
  320.  
  321.      Additionally, this command can be embedded into your messages-more
  322.      on this in the Messages Section.
  323.  
  324.  
  325.  
  326.      ╔════════════════════════╗
  327.      ║ SECTION VII - MESSAGES ║
  328.      ╚════════════════════════╝
  329.  
  330.      You may store 22 messages of up to 255 characters each to use
  331.      during transmission.  Then by selecting only one key, that message
  332.      will be displayed in your buffer and transmitted.  There are no
  333.      special requirements and the messages can be inserted while you are
  334.      typing just as if you were entering another character.
  335.  
  336.      Messages are automatically saved to your disk as you originally
  337.      enter them or change them.  All previously entered messages are
  338.      loaded when you start The Code Machine.  The messages are stored on
  339.      your disk in a file named TCM.MES.  If your program does not find
  340.      the TCM.MES file when it starts up, it creates a new one.  Ensure
  341.      that the disk containing The Code Machine has at least 6K of
  342.      available space in order to store your messages.  If you do not
  343.      have available space on your disk your TCM.MES file will be lost.
  344.  
  345.      To enter new messages or view previously stored messages, select
  346.      `Messages` from the Main Menu.  You will be prompted to select the
  347.      key that corresponds to the message you want.  After selecting the
  348.      key you will be shown the current message stored for that key and
  349.      asked if you want to change it.  Select `Y` to enter a new message
  350.      and `N` to return to the Main Menu.  After selecting `Y`, you are
  351.      prompted to enter a message.  Each message can contain between 1
  352.      and 255 characters.
  353.  
  354.  
  355.      The Code Machine provides a very powerful method for entering
  356.      messages containing the call sign of the station being worked.
  357.      Enter the colon [:] in any message and the call sign of the station
  358.      your are working will replace the colon when that message is
  359.      called.
  360.  
  361.  
  362.  
  363.                                      -6-
  364.  
  365.      
  366.  
  367.  
  368.  
  369.      Remember to select one key to represent your own call sign.  For
  370.      convenience, select a key that does not require you to use the
  371.      [SHIFT] key.
  372.  
  373.  
  374.  
  375.      ╔═════════════════════════╗
  376.      ║ SECTION VIII - PRACTICE ║
  377.      ╚═════════════════════════╝
  378.  
  379.      The Code Machine's practice programs use your computer's speaker to
  380.      output code at the rate previously selected with the WPM option.
  381.      Selecting `Practice` from the Main Menu drops down the Practice
  382.      Menu and allows you to select from seven different practice
  383.      programs.
  384.  
  385.      Choose Characters
  386.  
  387.      This option allows you to select individual characters you need to
  388.      practice.  You will be prompted to enter the characters you want to
  389.      practice.  You may select as many characters as you wish (up to
  390.      255). The characters will be randomly selected and placed in the
  391.      transmit buffer in groups of five.  You may select characters more
  392.      than once--their random selection will be proportional to the
  393.      number of times you select them.
  394.  
  395.  
  396.      Alpha Characters
  397.  
  398.      All twenty-six letters will be randomly selected and placed in the
  399.      transmit buffer in groups of five.
  400.  
  401.  
  402.      Numeric Characters
  403.  
  404.      Numbers 0 thru 9 will be randomly selected and placed in the
  405.      transmit buffer in groups of five.
  406.  
  407.  
  408.      Special Characters
  409.  
  410.      The special characters (see Section XI, "Special Characters") will
  411.      be randomly selected and placed in the transmit buffer in groups of
  412.      five.
  413.  
  414.  
  415.      Letters and Numbers
  416.  
  417.      All letters and numbers will be randomly selected and placed in the
  418.      transmit buffer in groups of five.
  419.  
  420.  
  421.      Total Character Set
  422.  
  423.      All letters, numbers, and special characters will be randomly
  424.      selected and placed in the transmit buffer in groups of five.
  425.  
  426.  
  427.                                      -7-
  428.      
  429.  
  430.  
  431.      Use Transmit Buffer
  432.  
  433.      This selection works identical to the Transmit Mode except that an
  434.      audible frequency is sent to the computer's speaker.  Text can be 
  435.      entered directly or sample tests and sample QSO's can be stored as 
  436.      messages and then called up in this practice mode.   Note: Users of
  437.      Versions below 2.0 will find no difference between this selection
  438.      and `Transmit` on the Main Menu.
  439.  
  440.  
  441.  
  442.      ╔═══════════════════╗
  443.      ║ SECTION IX - HELP ║
  444.      ╚═══════════════════╝
  445.  
  446.      Selecting help from the Main Menu will drop down an ON/OFF menu
  447.      that will let you toggle the help screen on and off.  If ON is
  448.      selected, the help screen will be displayed when you are in the
  449.      Transmit Mode.  This provides a quick reference to the special
  450.      characters while transmitting.
  451.  
  452.  
  453.  
  454.      ╔══════════════════╗
  455.      ║ SECTION X - QUIT ║
  456.      ╚══════════════════╝
  457.  
  458.      Selecting `Quit` from the Main Menu returns control of your machine
  459.      to DOS.
  460.  
  461.  
  462.  
  463.      ╔═════════════════════════════════╗
  464.      ║ SECTION XI - SPECIAL CHARACTERS ║
  465.      ╚═════════════════════════════════╝
  466.  
  467.      The following special characters and functions are supported by the
  468.      keys indicated:
  469.  
  470.  
  471.             [CONTROL] - [S] = Pauses transmission of characters
  472.             [-] dash = error
  473.             [\] backslash = KN
  474.             [/] slash = DN
  475.             [+] plus = AR
  476.             [=] equals = BT (double dash)
  477.             [;] semicolon = SK
  478.             [.] period = period
  479.             [,] comma = comma
  480.             [?] question mark = question mark
  481.             [SPACE BAR] = space between words
  482.             [ESC] escape = stops transmission, clears buffer, Main
  483.  
  484.             [BACKSPACE] = moves cursor one space left and clears the
  485.                           character in that space from the buffer
  486.  
  487.  
  488.  
  489.  
  490.                                      -8-
  491.      
  492.  
  493.  
  494.  
  495.      ╔══════════════════════════════════════════════╗
  496.      ║ SECTION XII - CONNECTION TO YOUR TRANSMITTER ║
  497.      ╚══════════════════════════════════════════════╝
  498.  
  499.      Keying your transmitter with The Code Machine Version  is a simple
  500.      matter of connecting two components, an optocoupler and a resister
  501.      or a relay and a diode, between the computers speaker port and the
  502.      transmitter.  Parts for either circuit are available at Radio Shack
  503.      for about two dollars.  Either the optocoupler or the relay will
  504.      completely isolate your computer from your transmitter. While there
  505.      are probably thousands of ways to connect your equipment, I would
  506.      suggest that any you come up with provide similar isolation
  507.      protection.  One other point, if you use a relay in the circuit, be
  508.      sure to use a diode to protect your computer from the back voltage
  509.      associated with inductive loads.
  510.  
  511.      I have put together schematics and directions for three different
  512.      circuits (including Radio Shack parts numbers). I would be more
  513.      than happy to send you a copy.  In fact, if you are not completely
  514.      familiar with the components I have been speaking about, I highly
  515.      encourage you to send for the schematics for these coupling
  516.      circuits.  Just send a self addressed stamped envelope (SASE)
  517.      (letter size with the minimum postage is fine) to:
  518.  
  519.                          Lloyd J. Wilson
  520.                          TCM Connections
  521.                          1530 W. Ranch Rd
  522.                          San Bernardino, CA  92407
  523.  
  524.         Note: There is no charge--please do not send money.
  525.  
  526.  
  527.      ╔══════════════════════════════╗
  528.      ║ SECTION XIII - DATE AND TIME ║
  529.      ╚══════════════════════════════╝
  530.  
  531.      The current date and time are shown at the top of your monitor. The
  532.      clock is suspended during code transmission.  Once you return to
  533.      the Main Menu the clock will update itself and resume.  You may use
  534.      the suspended time to mark the beginning of a QSO.
  535.  
  536.  
  537.      ╔════════════════════════════╗
  538.      ║ SECTION XIV - SYSTEM SPEED ║
  539.      ╚════════════════════════════╝
  540.  
  541.      The Code Machine relies on system timing to accurately calculate
  542.      code speeds.  Because of the many different system clock
  543.      frequencies used by various compatible computers, the program does
  544.      a test when started to determine the speed of your computer.  This
  545.      results of this test are then used as the basis for the timing of
  546.      your code.  For this reason, users with selectable clock
  547.      frequencies (often called turbo) should not change their turbo
  548.      setting during operation of the program.  If you change your turbo
  549.      option while running the program, it will be necessary to restart
  550.      The Code Machine so the program's timing can be adjusted to the 
  551.      computer's new clock frequency.
  552.  
  553.                                      -9-
  554.      
  555.  
  556.  
  557.  
  558.      ╔══════════════════════════╗
  559.      ║  SECTION XV - DISK FILES ║
  560.      ╚══════════════════════════╝
  561.  
  562.      The following files should be on your The Code Machine disk:
  563.  
  564.               TCM.EXE  (The Code Machine Program) TCM.SYS  (The Code
  565.               Machine Program) TCM.DOC  (The Code Machine Manual)
  566.               TCM.MES  (Message file - Created by the program if not on
  567.               the disk)
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.                                      -10-
  616.  
  617.      
  618.  
  619.